Node-RED block in Snap4City Microservice library node-red-contrib-snap4city-developer is "address-poi-search-by-text">
it allows to retrieve a list of street addresses and service names based on a text search. The search may be filtered
excluding POIs and to be within a maximum distance from a GPS position.
Inputs
A JSON with these parameters:
- search
string
- the keywords separated with spaces that have to match with any textual description associated with an entity.
- searchMode
string
- can be AND or ANDOR (default ANDOR), indicates if all or any word of the query need to match
- latitude
number
- latitude of a GPS position
- longitude
number
- longitude of a GPS position
- categories
string
- the list of categories of the services to be retrieved separated with semicolon, if omitted all kinds of services
are returned. It can contain macro categories or categories, if a macro category is specified all categories
in the macro category are used. The complete list of categories and macro categories can be retrieved on servicemap.disit.org
- maxdistance
number
- maximum distance from the GPS position of the services to be retrieved, expressed in Km (0.1 is used if parameter
is missing) if it is equal to “inside” it searches for services with a WKT geometry that contains the specified
GPS position (e.g a park)
- maxresults
number
- maximum number of results to be returned (if parameter is missing 100 is assumed), if it is 0 all results are returned
- excludepoi
boolean
- true or false (assumed false if missing), if true the search is performed only on street names, civic numbers and
municipalities
Outputs
- A GeoJSON FeatureCollection object with the matching objects
Details
The node can receive a JSON with the parameters described in the Inputs section and with them generate the output JSON.
If the values are not present in the input JSON, these are read by those in the configuration. If they are not present
in either part, an error is generated for the necessary parameters.